home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / less-252 / lesskey.man < prev    next >
Text File  |  1995-05-11  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4. LESSKEY(1)               USER COMMANDS                 LESSKEY(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      lesskey - specify key bindings for less
  10.  
  11. SYNOPSIS
  12.      lesskey [-o output] [input]
  13.      lesskey -V
  14.  
  15. DESCRIPTION
  16.      _L_e_s_s_k_e_y is used to specify a set of key bindings to be  used
  17.      by  _l_e_s_s.  The input file is a text file which describes the
  18.      key bindings, If the input file is "-",  standard  input  is
  19.      read.   If  no  input  file  is specified, $HOME/.lesskey is
  20.      read.  The output file is a binary file  which  is  used  by
  21.      _l_e_s_s.  If  no output file is specified, $HOME/.less is writ-
  22.      ten.  If  the  output  file  already  exists,  _l_e_s_s_k_e_y  will
  23.      overwrite it.
  24.  
  25.      The input file consists of lines of the form:
  26.  
  27.           _s_t_r_i_n_g <whitespace> _a_c_t_i_o_n [extra-string] <newline>
  28.  
  29.      Whitespace is any sequence of  one  or  more  spaces  and/or
  30.      tabs.   The  _s_t_r_i_n_g  is  the command key(s) which invoke the
  31.      action.  The _s_t_r_i_n_g may  be  a  single  command  key,  or  a
  32.      sequence  of  up  to 15 keys.  The _a_c_t_i_o_n is the name of the
  33.      less action, from the list below.   The  characters  in  the
  34.      _s_t_r_i_n_g  may  appear  literally, or be prefixed by a caret to
  35.      indicate a control key.  A  backslash  followed  by  one  to
  36.      three octal digits may be used to specify a character by its
  37.      octal value.  A backslash followed by b, e, n, r or t speci-
  38.      fies  BACKSPACE,  ESCAPE,  NEWLINE,  RETURN  or TAB, respec-
  39.      tively.  A backslash followed by any other  character  indi-
  40.      cates  that  character is to be taken literally.  Characters
  41.      which must be preceded by backslash  include  caret,  space,
  42.      tab  and  the backslash itself.  Blank lines and lines which
  43.      start with a pound sign (#) are ignored.
  44.  
  45.      An action may be followed by an "extra" string.  When such a
  46.      command  is  entered  while running _l_e_s_s, the action is per-
  47.      formed, and then the extra string is parsed, just as  if  it
  48.      were  typed  in to _l_e_s_s. This feature can be used in certain
  49.      cases to extend the functionality of a command.   For  exam-
  50.      ple, see the "{" and ":t" commands in the example below.
  51.  
  52.      The -V flag causes _l_e_s_s_k_e_y to print its version  number  and
  53.      immediately exit. Other flags and arguments are ignored.
  54.  
  55.  
  56. EXAMPLE
  57.      The following input file describes the set of  default  com-
  58.      mand keys used by less:
  59.  
  60.  
  61.  
  62.  
  63.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LESSKEY(1)               USER COMMANDS                 LESSKEY(1)
  71.  
  72.  
  73.  
  74.           \r        forw-line
  75.           \n        forw-line
  76.           e         forw-line
  77.           j         forw-line
  78.           ^E        forw-line
  79.           ^N        forw-line
  80.           k         back-line
  81.           y         back-line
  82.           ^Y        back-line
  83.           ^K        back-line
  84.           ^P        back-line
  85.           J         forw-line-force
  86.           K         back-line-force
  87.           Y         back-line-force
  88.           d         forw-scroll
  89.           ^D        forw-scroll
  90.           u         back-scroll
  91.           ^U        back-scroll
  92.           \40       forw-screen
  93.           f         forw-screen
  94.           ^F        forw-screen
  95.           ^V        forw-screen
  96.           b         back-screen
  97.           ^B        back-screen
  98.           \ev       back-screen
  99.           z         forw-window
  100.           w         back-window
  101.           F         forw-forever
  102.           R         repaint-flush
  103.           r         repaint
  104.           ^R        repaint
  105.           ^L        repaint
  106.           g         goto-line
  107.           <         goto-line
  108.           \e<       goto-line
  109.           p         percent
  110.           %         percent
  111.           {         forw-bracket {}
  112.           }         back-bracket {}
  113.           (         forw-bracket ()
  114.           )         back-bracket ()
  115.           [         forw-bracket []
  116.           ]         back-bracket []
  117.           \e^F      forw-bracket
  118.           \e^B      back-bracket
  119.           G         goto-end
  120.           \e>       goto-end
  121.           >         goto-end
  122.           =         status
  123.           ^G        status
  124.           :f        status
  125.           /         forw-search
  126.  
  127.  
  128.  
  129.                                                                 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LESSKEY(1)               USER COMMANDS                 LESSKEY(1)
  137.  
  138.  
  139.  
  140.           ?         back-search
  141.           \e/       forw-search *
  142.           \e?       back-search *
  143.           n         repeat-search
  144.           \en       repeat-search-all
  145.           N         reverse-search
  146.           \eN       reverse-search-all
  147.           \u        undo-hilite
  148.           m         set-mark
  149.           '         goto-mark
  150.           ^X^X      goto-mark
  151.           E         examine
  152.           :e        examine
  153.           ^X^V      examine
  154.           :n        next-file
  155.           :p        prev-file
  156.           :x        index-file
  157.           -         toggle-option
  158.           :t        toggle-option t
  159.           s         toggle-option o
  160.           _         display-option
  161.           |         pipe
  162.           v         visual
  163.           !         shell
  164.           +         firstcmd
  165.           H         help
  166.           h         help
  167.           V         version
  168.           q         quit
  169.           :q        quit
  170.           :Q        quit
  171.           ZZ        quit
  172.  
  173.  
  174. PRECEDENCE
  175.      Commands specified  by  _l_e_s_s_k_e_y  take  precedence  over  the
  176.      default  commands.  A default command key may be disabled by
  177.      including it in the input file with  the  action  "invalid".
  178.      Alternatively,  a  key may be defined to do nothing by using
  179.      the action "noaction".  "noaction" is similar to  "invalid",
  180.      but  _l_e_s_s  will give an error beep for an "invalid" command,
  181.      but not for a "noaction" command.  In addition, ALL  default
  182.      commands  may be disabled by adding this control line to the
  183.      input file:
  184.  
  185.      #stop
  186.  
  187.      This will cause all default commands  to  be  ignored.   The
  188.      #stop  line  should  be the last line in that section of the
  189.      file.  (Another section, introduced by #line-edit, may  fol-
  190.      low the #stop line.)
  191.  
  192.  
  193.  
  194.  
  195.                                                                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LESSKEY(1)               USER COMMANDS                 LESSKEY(1)
  203.  
  204.  
  205.  
  206.      Be aware that #stop can be dangerous. Since all default com-
  207.      mands  are  disabled,  you  must provide sufficient commands
  208.      before the #stop line to enable all necessary actions.   For
  209.      example,  failure  to  provide  a "quit" command can lead to
  210.      frustration.
  211.  
  212.  
  213. LINE EDITING
  214.      New key bindings may be specified for the line editing  com-
  215.      mands, in a manner similar to the way key bindings for ordi-
  216.      nary commands are specified.  This control  line  marks  the
  217.      beginning of a section of line-editing commands:
  218.  
  219.      #line-edit
  220.  
  221.      Following this line is a list of keys and actions,  one  per
  222.      line as in the example below.
  223.  
  224.  
  225. EXAMPLE
  226.      The following input file describes the set of default  line-
  227.      editing keys used by less:
  228.  
  229.           #line-edit
  230.           \t        forw-complete
  231.           \17       back-complete
  232.           \e\t      back-complete
  233.           \14       expand
  234.           ^V        literal
  235.           ^A        literal
  236.           \el       right
  237.           \eh       left
  238.           \eb       word-left
  239.           \ew       word-right
  240.           \ei       insert
  241.           \ex       delete
  242.           \e\b      word-backspace
  243.           \e0       home
  244.           \e$       end
  245.           \ek       up
  246.           \ej       down
  247.  
  248.  
  249.  
  250. SEE ALSO
  251.      less(1)
  252.  
  253.  
  254. COPYRIGHT
  255.      Copyright (c) 1984,1985,1989,1994  Mark Nudelman
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                 4
  262.  
  263.  
  264.  
  265.